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PRO/FILE CARTRIDGE UPDATE 


By the time this issue of Updates reaches you, I anticipate that I'll be up 

to be up to my hips in Pro/File 2068 cartridge boards, eproms, and 

instruction books. So if you ordered one, expect it to arrive soon. Several 
people who had never used Pro/File 2068 asked what sort of instructions 

come with the new cartridge version. Here is what comes with the cartridge: 1 
new copy of the Big Pro/File book; | copy of BREAKTHROUGH, the Pro/File 
addendum which shows you how to use the improved M.C. sorting facilities; and 
finally, a new 20 page instruction booklet which covers the new features of 

the cartridge such as the OR and NOT searching, use of the IBM keyboard, etc. 


Unfortunately, I could not afford to cover details on the bank switching 
mechanism or other points on how the program works.(Booo!) That would have 
delayed production substantially, and the price would have to be adjusted 
accordingly to account for more writing and printing costs. Pro/File is 

already expensive enough. Rather than include this meaty information with the 
cartridge, I have decided to include it here in Computer Updates. (Hooray!) 
Many of the new features can be applied to other programs, so even if you 
don't get the cartridge (Boohoo!), you can still see how it all fits 

together. 


KEYBOARD INTERFACING TIPS INSIDE! 


The first chapter of the explanation of Pro/File's inner workings is inside 
this issue and covers the INs and OUTs of hooking up an IBM PC keyboard. 
What's more, the routines given here make it possible to use this keyboard 
with ANY Basic program. The facility is much like using a "print driver" for 
a big printer. You can think of this article as giving you a "keyboard 
driver". You load it in, and type away. When I wrote this keyboard driver, 

I took special precautions to insure that it would run with the cassette 
version of Pro/File 2068. Let me tell you, it is NICE! 


NEW SYNCWARE GROUP PUBLICATION STARTING 


Attention QL owners: Now you've got a magazine of your very own. "Quantum 
Levels" is our newest project and the first issue is due out in August. Like 
SyncWare News, the new "Levels" is bi-monthly. It contains product reviews, 
hardware projects, program listings, tips on Super Basic, and hints on using 
the QL bundled software. It covers the QL exclusively. There's nothing in it 
about other computers. Cost: $18.95 per year. Send your subscription to: 
Quantum Levels, P.O. Box 64, Jefferson, NH 03583. 


INTRODUCTION TO CHANNELS ON THE 2068 


Did you know that your 2068 has a feature 
built-in to it which allows you to link new 
peripherals into Basic? It is possible to 

interface your computer to modems, keyboards, 
printers, other computers, or just about 

anything else you can think of and then use 

Basic commands like PRINT, INPUT, LIST, INKEY, 
LPRINT, or LLIST to send data out or receive 
data from these devices. 


It is the manipulation of STREAMS and CHANNELS 
which makes all of this possible. You probably 

have seen these terms mentioned before, but 

what they are and how to use them are topics 
which, until now, have been virtually ignored. 


So what are streams and channels and how do 
they relate to external peripheral devices? 
Imagine opening a valve to let water pass 

through a garden hose. Now imagine issuing a 
command to send a string of characters to a 
modem. In the garden hose you have the water 
itself which is the STREAM, and you have the 
hose which is the CHANNEL or pathway the 
stream is directed through. In the modem 
analogy, you have the string of characters 

(the STREAM) which is directed through a 
program (CHANNEL) which outputs the stream to 
the modem. A STREAM is the data which is to be 
sent in or out. A CHANNEL is the program which 
directs the flow to/from the peripheral. I 

should emphasize, the channel is NOT the 
peripheral itself, but the program which 

handles the peripheral. 


When you print characters such as the word 
"hello" to the TV screen you are sending a 
stream of data (the letters h-e-!-l-o) to a 
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program which puts those characters on your 
video display. Channels are given numbers to 
distinguish one from the other. The channel 
which prints to the TV screen is channel #2. 
The channel which prints to your printer is 
channel #3. Channel #1 is the routine which 
prints messages at the bottom of your TV 
screen. When you use the basic channel 
commands (PRINT, LPRINT, INPUT, INKEYS, LIST, 
and LLIST) the computer will automatically 
associate the proper channel number with the 
command if you do not specify some different 
channel. Thus the command, PRINT "hello", will 
put the word "hello" on your TV screen. 


However, you can override the default channels 
by specifying a different channel number. Try 


entering these unusual commands: 


LPRINT #2;"HELLO" 
LIST #3 (make sure your printer is on) 
INPUT #2,"NAME?"3#1;A$ 


You can also create your own channels in 

machine code and send streams of data to them. 
The article that follows this one shows how to 
connect an IBM keyboard to your computer. By 
creating a new keyboard channel, the commands 
INPUT and INKEYS can be made to take data from 
this big keyboard. How is this done? 


It is a two step procedure creating the 

channel and linking it to Basic. In the case 

of interfacing the IBM keyboard to the 2068, 
the first step is writing the software which 
determines which key you're pressing. Then you 
must link it to Basic. 


The link is made by building what is called a 
"channel table" which tells the computer where 
to find the channel program. Because a stream 
can travel in two directions (in or out of the 
computer), the channel table must provide 
addresses for a device INPUT routine and a 
device OUTPUT routine. The table should also 
include an optional "channel identifier" which 
tells the computer what kind of channel it is 
dealing with. This identifier is simply a 

letter of the alphabet which signifies a 
device: K for Keyboard, S for screen, P for 
Printer, etc. You must also tell the computer 
where to find the channel table. This is not 
difficult, but it does need some explanation. 


Earlier, | mentioned that there are already 
several channels present in the computer which 
handle streams from the 2068 keyboard, to the 


TV and to the 2040 printer. These channels 

also have a table which show where they are 
located. The 2068 system variable called CHANS 
(address 23631/2) points to the start of this 
table. You can look at this table by entering 
and running the short program below: 


10 LET START=PEEK 23631+256*PEEK 23632 

20 FOR X=START TO START+19 

30° PRINT. Xs"="SPEEK Xs TAB. 12s 

40 IF PEEK X<100 AND PEEK X>32 THEN 
PRINT CHRS PEEK X:NEXT X 

50 PRINT:NEXT X 


Each channel requires 5 bytes for its table. 
The first 5 addresses printed on the screen 
represent the 2068 keyboard channel. The first 
2 addresses of every channel table contain the 
address of the device OUTPUT routine. The 
second two addresses contain. the address of 
the device INPUT routine. The fifth and last 
byte is used for the channel identifier. The 
built-in channels all have their tables 

together in an area of memory which begins at 
the address pointed to by the CHANS system 
variable. 


When the computer needs to find an input or 
output routine address given in the channel 
tables, it does so by checking another group 

of 2068 system variables named "STRMS". These 
are 38 bytes which are described on page 262 
of the TS2068 operators manual. Unfortunately, 
the description given in the manual is 
horrendously incorrect. First of all, the 

name, STRMS, is misleading because the 38 
bytes are not "streams"; they are offsets to 
channels. Secondly, the book states that these 
bytes are "addresses of channels attached to 
streams." Again, they are not addresses, they 
are offsets. 


Specifically, each two byte "STRM" tells the 
computer how far the channel information (the 
table for the specific channel) is located 

away from the address specified in the system 
variable CHANS. The value stored in a STRM 
will always be | greater than the actual 
distance. 


Internally, the computer recognizes 7 built in 
channels. Their numbers are -3, -2, -1, 0, 1, 

2, and 3. For all practical purposes, you can 
ignore these channels. Their workings are 
invisible to you as you run your computer. You 
can, however peek the first few bytes starting 
at address 23568 to see the offsets. Use the 


listing below to print them on the TV screen: 


10 FOR X=23568 TO 23588 
20 PRINT X;"=";PEEK X 
30 NEXT X 


Here is a chart showing which STRM addresses 
represent which channels. 


STRM Offset Distance from Channel 
Adresses Value CHANS Number 
23568/69 1 0 -3 
23570/71 6 5 -2 
23572/73 1] 10 -l 
23574/75 1 0 0 
23576/77 1 0 1 
23578/79 6 5 2 
23580/81 16 15 3 
23582/83 not yet defined 4 
23584/85 not yet defined 5 
23586/87 not yet defined 6 
23588/89 not yet defined 7 
23590/91 not yet defined 8 
23592/93 not yet defined 9 
23594/95 not yet defined 10 
23596/97 not yet defined 11 
23598/99 not yet defined 12 
23600/01 not yet defined 13 
23602/03 not yet defined 14 
23604/05 not yet defined £5 


As you can see, channels 4-15 are not used 
internally by the computer. They are left for 

you to use with your add-ons. What must be 
done to create a new channel is to place a new 
channel table somewhere in memory and poke a 
new STRM with an offset which shows where this 
table is located. 


You can place your 5 byte channel table just 
about anywhere you want as long as it is at an 
address higher than that specified in CHANS. I 
have grown fond of the practice of placing 


_ channel tables in REM lines of basic programs. 


This fulfills the requirement that the table 
be higher than the existing channel 
information, and if the REM holding your new 
channel data is the first line of a program, 
its location is easy to determine. The first 
byte of such a table will always be 5 bytes 


- more than the address stored in the system ~ 


variable, PROG (23635 and 23636). 


So using the Keyboard article as an example, 
you locate your channel program in memory. The 
entry point of the keyboard software is 


ea ae 


address FD02 hex. Then you build a channel 
table in a REM line. This is done by entering 
a program line like: 


1 REM xxxxK 


The address of the keyboard OUTPUT routine 
will be the same as the output routine for the 
2068 keyboard (shown in the built-in channel 
table to be address 0500 hex). The first two 
x's must be poked with the output address 
(0500) and the second 2 x's must be poked with 
the input address (FD02). 


To find the address of the first "x" in the 
REM line, enter the command: 


PRINT 5+PEEK 23635+256*PEEK 23636 


Normally, this will give 26715 as a result. So 
the following pokes are then entered: 


POKE 26715,0 OUTPUT ROUTINE Equals: 
POKE 26716,5 0500 HEX 

POKE 26717,2. INPUT ROUTINE Equals: 
POKE 26718,253 FD02 HEX 


That takes care of the channel information. 

All that's left to do now is poke the first 
unused STRM with the proper offset. This 
address will depend on how many channels have 
already been set up. The STRM for channel 4 is 
at address 23582 and 23583. To determine the 
value to poke these addresses, enter these 
commands: 


LET CHAN=PEEK 23631+256*PEEK 23632 
LET TABLE=5+PEEK 23635+256*PEEK 23636 
LET OFFSET=TABLE-CHAN+1 

RANDOMIZE OFFSET 

POKE 23582,PEEK 23670 

POKE 23583,PEEK 23671 


Now a new channel 4 is fully linked to your 
Basic. Using the Basic commands PRINT #4, 
INPUT #4, etc. will direct your stream of data 
to your channel software. 


Describing how to make use of channels is much 
more difficult than actually doing it. What 
follows is an actual example which hopefully, 
you'll find far less abstract. 


HOW TO CONNECT AN IBM KEYBOARD 
TO YOUR TIMEX 2068 


This article shows you how you can use a full 
size IBM compatible keyboard with your 
computer and create a new channel to link it 
to your own Basic programs. My new cartridge 
version of Pro/File 2068 has the software part 
of this project built into the cartridge, and 

it can be used with any Basic program--not 
just with Pro/File. However, if you do not 
have the cartridge, or if you'd like to 
experiment with this on your TS1000, you can 
use this article to upgrade your cassette 
based programs to take advantage of a 
keyboard which is far better than the Timex 
keyboard. 


The TS2068's marvelous channeling feature lets 
you hook the IBM keyboard right into your own 
Basic. This means that the INPUT and INKEY$S 
commands can be taught to respond to the IBM 
keyboard instead of the 2068 keys. 
Unfortunately, the TS1000 is not this 

flexible, however the principals for reading 

the keyboard are the same for both computers. 
I'll leave further experimenting with the 
TS1000 to you. 


This project is fairly simple to build. All 
that's required besides a standard replacement 
keyboard for the IBM PC (such as the 
Keytronics Model 5151) is one of my 
Experimenter's I/O ports and a few 
miscellaneous electronic components. 


If you use a program which requires a lot of 
input from the keyboard, you'll be amazed by 
the improvement this project offers. The 
hardware shown here can be used with the 
TS1000/1500 too. 


General Principals: 
What IS the IBM Keyboard? 


Besides being a sturdy keyboard with a good 
feel to it, the IBM type keyboard is termed an 
"intelligent" keyboard because it has built-in 
circuitry which automatically scans the keys 
to see which one you press. When it finds you 
pressing a key, a serial steam of pulses is 
sent out through its data line (pin 2 of its 5 
pin DIN connector) which represents a "scan 
code" for the key you press. This stream of 
electrical pulses is very similar to the 
stream of dits and dahs which represent a 


Sips 


letter in Morse Code. Each key has its own '| The last important feature of the keyboard is is ay 

unique scan code. It is the job of the , that it will automatically send repetitive _ 

interface hardware and software to intercept scan codes if you press.a key and hold it 

the pulse stream and translate it into a ~ | down. While this bit of "intelligence" may _ 

character which. can. be understood by:.the,,. .. ... ~ work just fine on an IBM computer, it turns 

computer, . . ; eee rent ere _| out to be a major headache for the Timex, but | 
ns the keyboard software gets around this problem 

A clock line comes out through pin 1 of the and still manages to provide, me auto 

keyboard connector. This line also sends a repeating keys. 


serial stream of pulses at a fixed rate much 
like the ticks of a clock... only faster. The 


clock line makes it possible to "synchronize" | eee Entel sate Hardware Requirements : 

the reading. of the data line. It only ticks 

when data is being sent through pin 2. Each’ th order for the computer to make sense out of 

scan code consists of 8 serial pulses (or | the serial stream of keyboard data, some means _ 

bits). Therefore, the clock ticks & times for. ies of converting it into a parallel byte is 

each keypress. so". | necessary. The electronic circuitry shown here 
eae ee does this. The schematic shows the keyboard | 

Another characteristic of the IBM type’ ae data and clock lines on pins 2 and: 1 of the 

keyboatd js that each key ‘actually produces DIN connector respectively. ‘The serial data 

two different scan codes depending on whether — stream is fed to pin 2 of the 74164 serial to 

you press. down on a key (commonly called the’ © —'| parallel converter chip. The clock is inverted 

DOWN CODE) or release a key (called the UP” , | (highs become lows and lows become highs) by 

CODE).. The only difference between any given the 7404 and then is sent to the clock input 

DOWN or UP code is that the 8th bit of the © ° ——‘| pin (pin 8) of the 74164. These two lines are 

stream of. pulses will always be low for a DOWN _ | all that is necessary for the 74164 to convert. 

CODE and will always be high for an UP CODE. | the stream into 8 parallel bits. These outputs 

This means.that when the serial stream is . | (D7 through DO) must then be connected to 

converted into an 8’bit number, an UP CODE for their respective places on the IN/OUT board's 

a specific, key will always be 128 (that's 80° ‘input: lines. 

hex) more than the Corresponding DOWN CODE. H : 

Because ‘of. this, it is very easy for the” . ‘The power supply lines (y's and Gnd) necessary . 

software to tell if you are pressing down on a’ | ‘to run‘both the converter and the keyboard can . 

key or if you have released it (pressing up?). |_| be taken directly from the 1/0 Port. 

If the scan code. is less than 128, your finger . 
is on a key. If it is greater than 128 you aid | | Wiring this circuit is easy. There's s nothing 


have released it. rae “| eritical about the way lines are layed 


.. Serial to Parallel Converter: Circuitry 
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out. Just make sure all the connections go to 
the right places. 


Whenever I build circuits like this, I like to 
do them on solderless bread boards which are 
available at Radio Shack. Once I have 
everything working properly, I take it apart 


Table 1. IBM Keyboard Software Pokes 


Address Value Address Value Address 
64770 205 64817 194 64864 
64771 30 64818 253 64865 
64772 253 64819 254 64864 
64773 121 64820 170 64867 
64774 12 64821 406 64868 
64775 32 64822 15 64869 
64776 2 64823 254 64870 
64777 207 64824 182 64871 
64778 12 64825 40 64872 
64779 167 64826 11 64873 
64780 202 64827 254 64874 
64781 14 64828 1984 64875 
64782 12 64829 40 64876 
64783 32 64830 20 64877 
64784 59 64821 190 6487s 
64785 92 64832 32 64879 
647846 203 64833 26 449880 
64787 238 64834 1 64881 
64788 50 649835 a 64882 
64789 8 64836 0 648983 
64790 892 64837 201 64884 
64791 55 64838 175 64885 
64792 195 64839 119 64886 
64793 14 64840 33 64887 
64794 12 64841 195 44888 
64795 209 64842 253 64889 
64796 16 64843 203 64890 
64797 253 64844 86 64891 
64798 1 64845 32 64892 
64799 207 64844 243 64893 
44800 80 64847 203 64894 
64801 76 64842 142 44895 
64802 175 64849 24 64896 
64803 237 464850 239 54897 
64804 120 64651 175 648e8 
64805 245 64852 119 S489 
64806 16 464853 32 44700 
64807 250 64854 195 64701 
464808 68 642855 253 64902 
64a07 209 64854 203 64903 
64810 1864 4642857 124 64904 
64811 32 44853 24 64905 
64812 229 6485? 220 64906 
64813 16 64860 119 64907 
64814 250 64861 203 64908 
64815 79 64862 127 64909 
64816 33 64863 32 


Value 
225 


and rebuild it on perfboard with soldered 
connections. 


Once you get your circuit built, connect it to 
your computer and test it out. Enter the test 
listing (the Basic line 10 which immediately 

follows the Keyboard table) on the next page. 


Address Value Address Value Address Value 
64910 126 54957 24 65004 59 
64911 50 64958 144 65005 39 
64912 196 44959 14 45006 39 
64913 253 64940 255 45007 if] 
649914 78 64961 201 65008 92 
64915 6 44982 Q 65009 122 
49916 0 64963 0 65010 1206 
64917 58 64984 0 65011 ied 
64918 194 64765 f] 65012 118 
64919 253 64954 199 65013 78 
64720 201 64967? 49 65014 110 
44921 33 64968 50 65015 109 
64922 120 S496" Sl 65016 44 
64923 254 44970 52 45017 464 
64924 24 64971 S23 65018 4? 
64925 230 54972 34 é65qi9 0 
$4924 203 64973 55 465020 203 
64927 206 64974 5S 65021 a 
64925 24 64975 5? 65022 32 
64927 160 649746 48 65023 0 
64930 203 64977 45 65024 0 
64931 198 64973 41 65025 205 
64932 24 64979 12 65026 224 
64933 154 $4730 > 45027 ? 
64934 175 44781 113 65028 4 
64935 50 64932 119 65029 8 
464936 194 64983 101 465030 190 
64937 253 64934 114 45031 11 
64738 58 64¢S5 116 45032 ? 
649389 196 64986 121 65033 15 
64940 253 6498? 117 65034 0 
44941 é 44788 105 65035 a 
44942 a 64°93? 111 65036 55 
64943 {4 64790 112 65037? 36 
44¢4q 254 64991 Fi 65038 57 
649955 79 44992 93 65039 45 
64944 201 64993 13 65040 S32 
64947 203 54994 Fa 65041 s3 
6494S 84 E4995 97 45042 54 
44949 32 649946 115 65043 43 
44950 4 64997 100 465044 49 
464951 203 44973 102 45045 50 
64752 214 64799 103 65044 S51 
64753 24 45000 104 45047 48 
64°54 227 45001 106 65048 46 
44955 203 45002 107 65049 a 
647546 150 465003 108 465050 199 


Address Value Address Value Address Value 
é50581 a3 45082 ro 65113 8 
45052 44 45083 Fil 45114 10 
S5053 Cia) 45084 72 45115 il 
45054 36 45085 7 45114 > 
S35055 a? 45084 7S 65117 15 
45054 v4 65087 Fé 435113 is) 
45057 Be 45088 S& 4511 qa 
45058 42 65089 34 45120 55 
45059 40 65090 3? 65121 a6 
S5040 41 65071 a 45122 a? 
A504 a 45092 2 S5123 45 
65042 43 45073 90 45124 52 
45042 12 4504 88 65125 53 
450.44 > 65095 4? 435126 Se 
65065 Si 45094 84 65127 43 
$5044 8? 65097 66 45125 49 
435047 ae 45098 73 55129 5a 
45048 Sz 650%9 7? 45130 ai 
45089 a4 65100 40 65131 48 
45070 ae $5101 é2 45132 44 
45071 eS 45102 43 65133 1i?s. 
435072 73 65103 iF) 45134 il 
65073 7? 45104 202 45135 1?? 
45074 so 65105 a 435134 45 
45075 123 451046 32 65137 8 
430 44 125 65107 G $5138 a 
65077 13 45108 i) 45139 9 
4507S 4 65109 205 63140 43 
45079 rb 65110 2264 435141 195 
435080 83 S51ii ? 45142 id 
45061 68 45112 4 65143 1i?s 
10 PRINT AT 1,0;IN 2233" "s GO TO 10 


note: 3 spaces between the quotes 


Press different keys on the IBM keyboard. Line 
10 will continuously read the keyboard port 
and print the keyboard scan code. Notice that 
each key produces its own unique pair of UP 
codes and DOWN codes, and that the UP code 
will equal the DOWN code plus 128. 


Keyboard Software 


To use the IBM keyboard with your 2068, poke 
the values shown in table 1 into addresses 
64770 through 65143. Use your favorite loader 
program to do this or enter and run the simple 
loader shown below: 


10 CLEAR 64769 

20 FOR X=64770 TO 65143 

30 INPUT "VALUE FOR ";(X);"?";Y 
40 POKE X,Y: PRINT X5"=";Y 

50 NEXT X 


After all the bytes have been poked, save it 
off to tape with the command, 


SAVE "IBM"CODE 64770,375 


Now, any time you want to use the software, 
load it into your computer by using the 
command, 


LOAD "IBM"CODE 


Then add these lines to the basic program you 
wish to use the IBM keyboard with: 


1 REM xxxxK 

2 POKE 246715,0: POKE 267164,5: 
POKE 24717,2: POQOKE 26718,253: P 
OKE 23582,28 


Line | is the "channel table". It is vitally 
important that it be the first line of your 
basic program. This software also assumes that 
your program starts at the normal starting 
address of 26710 decimal. Line 2, pokes the 
"x's" in line 1 with the values necessary so 

the computer will know how to find the 
keyboard software. The first two pokes are the 
address of the channel OUTPUT routine. The 
second two pokes are the address of the 
channel INPUT routine--the address of our 
keyboard software. The last poke which goes to 
the streams table gives the distance from the 
new keyboard channel table to the start of 
normal channel table. You can change line 2's 
line number if necessary, but the line MUST be 
executed BEFORE you try to read the IBM 
keyboard. 


And how do you read the keyboard? Well, the 
keyboard can be read by any Basic Input or 
Inkey$ command which specifies channel #4. For 
example: 


INPUT #4;"MAKE YOUR SELECTION";A$ 
LET YS$=INKEYS#4 
INPUT "HOW MUCH"s#4;X 


Therefore, what you must do is go through your 
basic listing and change every occurence of 
INPUT and INKEYS to INPUT #4 and INKEYS#4. 


The IBM keyboard will function only when the 
program is being run. When you stop to edit 
program lines you must use the 2068 keyboard. 


The INPUT #4 command accepts keypresses from 
both the IBM and the 2068 keyboards. The 


ey ae 


INKEYS#4 command is different in that it reads 
only the IBM keyboard. If you want to make it 
possible to read BOTH keyboards using INKEYS, 
enter a program line something like this: 


LET K$=INKEYS+INKEY$#4:IF LEN K$>1 
THEN LET KS$=KS(1) 


This line will read both the 2068 keyboard and 
the IBM keyboard into k$. If no keys are 
pressed, or if just one keyboard or the other 
is being used, KS$ will be empty or will equal 
the character being pressed. If you press keys 
on both keyboards simultaneously, KS will 
assume the value of the 2068 keyboard only. 


Features of the Keyboard Software 


All standard ASCII characters (letters, 

numbers, and punctuation marks) work according 
to the symbol printed on the key. There are 10 
special function keys which I have 

pre-defined. Because this software was written 
primarily for use with Pro/File 2068, these 
function keys are set to perform various 
functions within that program. 


Fl-Auto Repeat. Hold this key down to repeat 
the last keypress. 

F2-STEP Token (Step to next file in Pro/File) 

F3-STOP token (Close file in Pro/File) 

F4-CHRS 7 (INSERT/OVER switch in Pro/File) 

F5-CHRS 4 (Line Delete in Pro/File) 

F6-Cursor LEFT 

F7-Cursor DOWN 

F8-Cursor UP 

F9-Cursor RIGHT 


F10-CHRS 15 (More Commands in ADD/EDIT mode) 


The shift and caps lock keys work as you would 
expect. Holding shift and some other key will 
produce upper case. The caps lock key is an 
upper/lower case switch. Press it once to make 
all keypresses upper case. Press it again to 
make all keypresses lower case. 


Defining Alternate Keys on the IBM 


The ALT key is an ALTernate shift key, however 
its function is not to produce upper case 
characters. ALT can be pressed along with some 
other key to produce your own custom defined 
character. At the start, pressing ALT and some 
other key will have no effect because you 
haven't defined any keys yet. Here's how to do 
it. 


% 


The table below shows memory addresses which 
store the key code to be used when you press 
ALT with some other key. If you poke a key 
address with the code for the character you 
wish the key to represent, you can obtain that 
character when you simultaneously press ALT 
and the desired key. 


Address IBM ker Address IBM Ker 
45145 Esc 45187 ‘ 
65144 i 65188 Zz 
6514? 2 6518? x 
63148 3 635190 c 
65149 4 65171 u 
65150 a S512 b 
45151 & S143 n 
65152 ? $5194 m 
45153 8 6515 p 
45154 F S516 . 
49155 0 éaie? 7 
S35156 - 6517S not used 
45157 = 65199 Pr Ser 
491538 Back Sp] 45200 nat used 
465139 TAE 6az01 Space 
435160 q 63202 nat used 
éS1él WwW 45202 net used 
45142 e 435204 F2 
651463 r 45205 F3 
45164 t 63204 F4 
65145 ¥ 65207 FS 
S35146 u 45208 FS 
65167 i 65209 F? 
65168 a 653210 Fe 
5149 p S211 F9 
63170 t 465212 Fido 
&Si71 j 69213 NUM LOCK 
45172 RETURN 45214 net used 
435173 CTRL 65215 HOME 
635174 a 45216 Cur UP 
635175 $ S217 Po up 
S5176 d 432198 = 
65177 f 6521? Cur LEFT 
45178 Q 65220 Alt 5 
S517? h 45221 Cur RIGHT 
65180 Jj 65222 + 
651G1 kK 65223 End 
65182 1 65224 Cur GOWN 
45183 ; 65225 Pq DOWN 
45184 ‘ 45226 Ins 
65185 ‘ 65227 Del 


69186 not used 


The addresses on the next page give keys in 
UPPER CASE mode. Access them by pressing 
SHIFT and ALT simultaneously with one of 
the other keys. 


Address IBM Key Address IBM Key 
65229 ESC 635271 ! 
635230 ' 635272 2 
635231 a 63573 x 
45232 # 65274 Cc 
65233 $ 635275 V 
435234 vA 65276 B 
63235 - 63277 N 
45236 & 65278 M 
635237 * 635279 < 
45238 ¢ 635280 > 
65239 y) 65291 ? 
45240 _ 45282 not used 
65241 + 65283 PR SCR 
65242 Back Sp 65284 not used 
65243 TAB 635285 SPACE 
65244 Q 65286 not used 
65245 W 65267 not used 
45244 E 45288 F2 
45247 R 63289 F3 
45248 T 65290 F4 
65249 Y 65291 FS 
463250 u 435292 Fé 
65251 I 65293 F? 
65252 a) 45294 FS 
65253 Pp 65275 FS 
65254 £ E5296 Fio 
65255 3 45297 NUM LOK 
65256 RETURN A529S not used - 
65257 CTRL 65299 HOME 
65258 a 65300 CUR LIF 
65259 $ 45301 PAGE UP 
435260 D 465302 - 
65261 F S5302 CUR LEFT 
S5242 G 45304 pa 
65263 H $5205 CUR RIGHT 
65264 J 453045 + 
452465 K 65307 END 
52645 L 45308 CUR DOWN 
S524? : 65309 PG DOLIN 
45263 a 45300 INSERT 
65269 as 65301 DELETE 
435270 not used 


Here is an example of how you might define a 
key. Say you want to make it possible to 
produce the AND token whenever you press ALT 
and F10 together. What you must do is 
determine the code for the AND token. You'll 
find the code listed on page 244 of the 2068 
owner's manual. The table printed there shows 
that the number 198 is the code for AND. Now 
refer to the table above and change the 
address representing F10 so that it stores the 
value 198. Enter the command: 


POKE 65212,198 


to change the value representing the F10 key. 
Now, any time you press F10 and ALT 

together, you will get the token AND. This 
works as long as you are in lower case. If you 
want F10 to respond the same way in upper case 
as well, you must also POKE 65296 with a 198. 


IBM Keyboard Disassembly 


FON2 
FDOS 
Fo04 
FON? 
FOO? 
FDI 
FOOB 
FoOC 
FDOE 
FD12 
Fo14 
FDI? 
FO18 
FDIB 
FDIC 
FOIE 
FD21 
FD22 
F023 
FO25 
Fe 4 
FD28 
FO29 
Fn2eé 
FD2B 
FO2D 
FO2F 
FDO 
FO3A 
FOSS 
FDR? 
FDR 
FD3B 
FDaD 
FO3F 
FOdaa 
FDa2 
FDS 
Fo44 
FDA? 
FO48 
FD4B 
Fo4aD 
FN4F 
FOS 


COLEFR KE? 


7? 


CBEE 

R2085C 

a? 

CS0ENC 

O1 STAaK 
1aFD CLER 
OICrSA IT BMS 
40 

AF 
EN?S 
FS 
ties 
44 

mi 

BS 
2NEF 
InFe 
dF 
2PICSFD 
FEAA 
780F 
FERS 
Pare 
FEBS 
2ei4 
BE 
201 
O1ocon 
Cy 

AF 

7? 
ZICSFR 
CRS 
ZOFS 
CBRE 
{SEF 


SAMP 


WITT 


LINSSH 


CALL TEMS 

LD A,C 

INC fC 

JF NZ ,FDOR 
RST NSH 
Error D— 
AND 

JP 2,0Cne . 
LO HL,SC36 
SET &,¢HL) 
LQ ¢SC08) A 
SCF 

JP ACE 

POP DE 
DIN? , STAK 
LP BC, SOCer 
LD H,B 

xTIR A 

TH A, CD) 
PLISH SF 
DIN? , SAMP 
LO RH 

POP DE 

cP op 

JR N2,CLER 
DIN? , Fao? 
LD CLA 

LM HL ,LSCN 
GP 
JR 2, UINSH 
CP 
ATR 
CP 
JR 2, UNG@L 
CP CHL 

JR N?, CHAR 
LD BC,O0n0 
RET 

xOR A 

LD CHL? ,.Aa 
LD HL,KFLG 
RIT 2,¢HL? 


JR ONZ, QUIT 
RFS 1,¢HL) 
JR UIT 


Keyboard Disassembly Cont. 


FOSS Se LINE XOR & 

FOSd FF Lh CHL A 
FOSS 2ICSBFh Lm HL, KFLG 
FOSS Chess RES O,¢HL? 
FOS IGE WR GLUT T 
FOS 7? CHGR LO CHL A 
FOS CAPE BIT F,A 
FOSF Soet JRFONZ QUIT 
FDS) 2ICRFD LOD HL ,KFLG 
Fn46d FEAS TP 44 

FDS4 SER? JF 2, BRAK 
FOAS FESA MP Zey 

FOSS SARs? JR 2, SHET 
FOS FESS (TP ooB4 

FOSE 282E JR 2, SHET 
FO? FESA Ce 3 

FOY2 SAF JR 2, CAPS 
FO?Y4d FESR CP SR 

FOS SESE Jk 7 ,REPE 
FOrS FESS FP 38 

FRPA SAA JF f,ALT. 
FOFC FE [DCO LO A,f HLS 
Fovh CRa?r RIT 9,4 
FOFF 2018 JF NZ, SPEC 
FOS 2iCSFD LB HL. TRLO 
FOs4 CR4F BIT 1,.A 
FDS4 2SNS JR 2, LOR 
FOSS C5 HPPR FISH BC 
Foes OER4 LD C,a4 
FOSE i? abp HL .Bt 
Foer 4 POP BC 


PRO/FILE BITS & PIECES 


Charles Stelding from Tyler, TX writes... 
"Pro/File 2068 makes an excellent calendar and 
daily schedule. I use it in my work as a 
Campus Minister at Tyler Junior College. Here 
is a print out showing how I use the calendar. 


APRIL 1985 


SoM OWE OT, OR Ss TO READ 
CALENGAR 
1! 2: 3 4 $$! 6 TYPE DATE 
“APRIL i* 
e BP Oise 71.72.43 
14 15!'16!17 18 19 26 
21 22 23!24 25 26!27! 


FORD 0° LOWR ADD HI, BC 
FDSE 7E LD A,¢HL) 
FDSF 32C4Fn LD ¢LASK) ,A 
FDS? 4E LD C,¢HL) 
FOSS OA LO 6.00 
Epes S4C2ED LD &,¢LSCND 
Enea ce RET 

FD99 217@FE SPEC LP HL,TBLI 
FDSC 1Sk6 JR FDe4 
FDSE CBCE SHFT SET 1, CHL? 
FAN 184n JR QUIT 
FDAZ CBCé ALT. SET ,CHL) 
FRSd Peer JR OUT 
FDAGé OF REPE XCIR A 

FORA? 3202FD LD ¢LSCN).& 
FDAA SAC4FD LD A,CLASK) 
FDAD o40n LD 6,00 
FDAF 10FE DUN? , FDAF 
FOBI 4F LD C.A 
FDR? Cc? RET 

F0G2 CRS CAPS BIT 2,¢HL) 
FDBS 2004 JR NZ,FPBR 
FDR? CEDS SET 2,¢HL) 
FDR? 18E2 JR SHET 
FDBE CRe4 RES 2,¢HL? 
FORD 1896 IR FDA 
FORE EFF BRAK LD C,FF 
FORT my RET 

FDC? an LSCN NOP 

FDCa an KFLG NOP 

Fora an LASK NOP 

Focs an TAL NOP 


I place a "!" after each day that something is 
scheduled which allows me to view the entire 


month. You 


can then view the specific day of 


things scheduled by typing in the month and 


day. 
APRIL 


11:38 


2:98 


a 
“ 


Work up calendar schedule 
For next year ¢o hand in 
+0 MS, Pratter, 

Get things Finalized for 
the Rel, Emphasis week 

a, Gheck school calendar 
&. Call McCaghren 

e,. Line up singers 
Student lunch 


Table talk 


Note: Although this application is used on 
Pro/File 2068, you can do the same thing with 
ZX Pro/File for the TS1000 


-10- 


And from B.R. Downey, E. Lansing, MI... 
"How can I take the asterisk off of the first 
line in ZX Pro/File when I make mailing 
labels?" 


Unfortunately, it is absolutely impossible to 
remove the asterisk completely without a major 
rewrite of the program. However, you can avoid 
printing the "*" when making mailing labels. 
The asterisk is present only on the first line 

of any record. It is printed, therefore, only 
when you try to print the first line. If you 
arrange your data so that a name and address 
starts on line 2, you can set your DEFP 
accordingly so that the first line with the 

"x" will not be printed. 


From Robert Hartung, Huntertown, IN 
",..Pro/File 2068 owners who are using 
Spectrum ROMs or emulators will be interested 
to know that the Pro/File print driver 
requires just two pokes to make it work with 
the Spectrum ROM. The Call address for the 
break scan needs to be changed from 63688=9 
and 63689=32 in the original (Pro/File) 
location to 63688=84 and 63689=31 for the 
Spectrum ROM. After doing this, the Pro/File 
adapted to the Spectrum will Lprint 
perfectly." 


Editor's note: These addresses can be found in 
the POKER TABLE on page 118 of the "Big Book". 
While on the subject of Spectrum 

compatibility, Pro/File 2068 must get 2 pokes 

to its machine code and some of its Basic 
program lines changed in order for it to run 

in the Spectrum. Addresses 63666 and 63667 you 
must poke to zero. All ON ERR commands must 
be deleted. The easiest way to find them is to 
run the program in a spectrum and wait for the 
computer to stop with a "Nonsense in Basic" 
error report. Then list and edit the offending 
line, deleting the parts which cause the 

error. Removing these commands causes no ill 
effect on the program's operation other than 

the fact that the machine may stop with an 
error if you try to input faulty information 

or if you press BREAK while in the ADD/EDIT 
mode. 


A few thoughts from Basil Wentworth, 
Bloomington, IN ...Applying Pro/File 2068 to 
my index of music manuscripts, I can never 
remember whether to search for Tuba, or TUBA, 
or tuba, so I added the line: 


ce 


10 POKE 23658,8 


which puts everything in capital letters. This 
also makes it easier to enter the key letters 
called for when I'm building a file. 


Second, I added line: 
60 PRINT TAB 4;""INDEX gives Subjects" 


Then I make one entry into the file something 
like the following: 


INDEX TITLE COMPOSER INSTRUMENT(S) TYPE 
FILE LOCATION etc etc 


and one of my records would look something 
like: 


THE AERIALIST BASIL TUBA AND PIANO/BAND 
BRAVURA HUMOROUS CIRCUS RED FOLDER 


and maybe some information about where I have 
already performed the piece. Now, by searching 
for "INDEX" first, I can find whether there's 
any point in looking for BRAVURA, or whether I 
have to try VIRTUOSO or TOUR DE FORCE or 
FLASHY AND TRASHY or whatever. 


Editors note: The use of an INDEX file or HELP 
file is a very useful aid which works in both 
the TS1000 and the 2068 versions of Pri/File. 
In my own use of the programs to manage 
mailing lists, I have several different 
programs and each one uses different lines for 
a person's name and address. In each program, 
I have added a file which tells where the 
name, street, etc is to be located. I also put 
the word "HELP" somewhere within this file. 
Then when I need a reminder to tell me what 
line to put my data on, I type "HELP" as a 
search command. The computer will then find 
and display my HELP file and I have my 
reminder. It saves hours of fustration. 


KKKEKHKEHHEKHHKKHKKE KKK HEHEHE KEKE HK 


32K NON-VOLATILE MEMORY UPDATES 


Here is a simple modification you can make to 
the NVM which enables you to remove an old 
battery and plug in a new one WITHOUT losing 
the program you have stored in it! It is 
amazing, but true. After removing the battery, 
you can diddley-bop around for 5 minutes (!) 
and still have time to plug in a new battery. 


This mod is so good, we have started including 
it with all new RAMs we ship. However, if you 
have an older model, you can add it yourself 
by following the instructions below: 


1. Locate the small capacitor which is 
immediately to the right of the write/protect 
switch. 


2. If the capacitor is an electrolytic "can", 
go no further. Your NVM is already fitted. 


3. If the capacitor is a small tear-drop 
shape, remove it with a grounded soldering 
iron (the 3-prong type). 


4, Replace it with a 220 uf, 16 volt 
electrolytic capacitor (Radio Shack #272-956). 
The negative lead of the cap should be 
connected to the hole which connects to the 
big fat ground trace. This is the hole which 

is located closest to the "DK" legend printed 
next to the Dock/Exrom Switch. 


I find it simply amazing that this capacitor 
can keep memory alive for 5 minutes without 
any battery connected. It is testament to the 
infinitesimal current drain of the NVM, that a 
capacitor can hold the ram for so long. 


KKKEHKKKKEKEKEHKEKKEKEKKEKKEKHKEKHE 


HOT Z CLINIC 


Last time, we looked at the details 

surrounding HOT-Z's READ mode. This issue, 
we'll use HOT-Z to write some machine code. 
The program we write will not be a masterpiece 
that sends shivers up your spine. Instead, it 

will be something short and sweet, but it will 
demonstrate the way you use HOT-Z to write 
code. What I have chosen is a machine code 
routine which will tell you how many bytes of 
free memory you have which can be used for 
additional Basic program lines and variables. 
The TS2068 already has this function built 

into its Basic language. This is the FREE 
function. When you execute the command PRINT 
FREE, it prints out the number of "free" bytes 
which are still unused. All you 2068 owners, 
please bear with me as we go through the 
examples. The intent here is to learn how to 
use HOT-Z, not to receive spoon-fed programs. 


Load HOT-Z into your computer, and work your 
way to the disassembly display in READ mode as 
shown in the last issue. The first step in 
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writing machine code with HOT-Z is deciding 
where in memory our program should be located. 
The object is to pick a convenient place which 
will not be get in the way of the Basic 
operating system. Machine code programs can be 
placed just about anywhere, but if you don't 
take special precautions, the Basic operating 
system will not intuitively know where it is. 

As a result, your machine code can be erased 
accidently without you even knowing about it. 
The Basic is like an elephant and your machine 
code program is an ant. You must be careful 
not to be trampled. 


Fortunately it is very easy to set aside an 
area of memory and tell the Basic system to 
leave it alone. The time honored tradition in 
the TS1000 is to create a REM line in basic 
which contains enough blank spaces to hold 
your code. As you shall see, this can also be 
done on the 2068. When you enter a Basic REM 
line which contains some number of letters or 
spaces after the rem token, you are using the 
operating system itself to set aside a block 
of memory as a basic program line. The 
characters or spaces that you start with can 
then be changed into machine code 
instructions. 


Another way to set aside memory for M.C. 
programs is to tell the computer there is less 
memory attached than what there really is. 
This technique is called "lowering ramtop". 
Using this technique, the highest addresses 
are made unavailable to the Basic. As more 
program lines and variables consume memory, 
the computer will eventually reach a point 
beyond which nothing more can be added. It 
will stop with an "Out of Memory" error. In a 
computer with a lowered ramtop, the computer 
will run out of memory before reaching the 
actual top of ram. The bytes you set aside by 
lowering ramtop are safely preserved and will 
not be accidently overwritten.In our program, 
we shall choose the first option of reserving 
bytes: creating a REM line. 


Going from HOT-Z to Basic 


To do this, use the QUIT command to turn HOT-Z 
off. On the TS1000, press SHIFT and the letter 
"QO", On the 2068, press Symbol Shift and the 
letter "Q". The result is the same in both 
computers: HOT-Z is turned off and the Basic 
operating system is restored. 


Now enter a rem line with 50 "X"'s following 
the REM token. After the line is entered, the 
screen should look like: 


1 REM XXXXMMMKRMMMMMMAMER MMAR 
HAR XXKAR MMMM MAMA 


Going From Basic to HOT-Z 


Now we can go back into HOT-Z and change those 
"X"'s into real machine code commands. If you 
use the TS1000, enter the command RAND USR 
22528. To turn the 2068 HOT-Z back on, enter 
RANDOMIZE USR 24098. This puts us right back 
in HOT-Z's READ mode. The next task is to use 
HZ to find the rem line we just entered. 


Find the Basic Program With HOT-Z 


This is simple on the TS1000. The owner's 
manual states that All basic programs start at 
the address 16509 in decimal. The 2068 is a 
bit different in that Basic programs need not 
always start at the same address. Different 
hardware or software configurations may cause 
a program to start in a different position. 
There is, however a 2068 system variable 
called "PROG" which will always hold the 
address where the Basic program begins (see 
page 263 of the 2068 owner's manual). PROG is 
a two byte variable at address 23635 and 
23636. 


Read Memory by Inputting a Decimal Address 


In the last issue we talked about displaying a 
specific group of addresses by typing in a 4 
digit hex address to make HOT-Z display a 
screenful of bytes starting at the address you 
type in. HOT-Z includes a very nice feature 
which lets you type in the starting address in 
decimal too. This is very useful in our case 
where we need to jump to decimal 16509 in the 
TS1000 or decimal 23635 in the 2068. 


If you use the TS1000, type SHIFT and "3". 
2068 owners should press Symbol! Shift and "U". 
This tells HOT-Z to expect a 5 digit decimal 
number rather than a 4 digit hex. After 
pressing these keys, the top left of the 

screen will change (this is where it says 
"ADDR") to make room for a 5 digit input. 


Now you can type in an address in decimal. For 
the TS1000, type 16509 to make the computer 
show you the start of the Basic Program. For 
the TS2068, type 23635. This will show you the 
values of some of the 2068 system variables. 
The top two bytes will be the address of the 
start of the Basic program. The 2068 will show 
address 5C53 holding the value of 56 and the 
address 5C54 holding the value 68. One might 
deduce, therefore that the address of the 
Basic is 5668 hex, but that is incorrect. All 
computers store numbers in the exact opposite 
order that humans do. To the computer, a 56 
followed by a 68 translates to the hex address 
of 6856. Now that we have looked up the 
address in PROG, we can make HOT-Z display 
this area in memory simply by typing the 
address in. So type: 6856. At this point, both 
in the TS1000 and the 2068, HOT-Z should be 
READING a disassembly of the start of your 
Basic REM line. 


It doesn't look much like a rem line does it? 
This is because Basic program lines are NOT 
machine code, they are data which. is 
interpreted by the ROM. Since the computer is 
in the disassembly mode right now, it is 

trying to disassemble data. The result is a 
nonsensical display. You may recall that we 
covered this type of situation in the last 

issue Refer to it for more details. To view 

the program line properly, we must go to the 
DATA MODE. On the 2068, press Symbol Shift and 
"G". On the 1000 press Shift and "D". Do you 
see the REM token and the "X"'s which make up 
your program line now? The REM token should be 
found on the fifth line of the data display. 
Below it, you will find the first screenful of 
X's which you typed in. You may be wondering 
what the top four lines of the data display 
represent. These are the addresses which hold 
the decimal values 0, 1, 52, and 0 

respectively. I refer you to your computer 
manual--the chapter entitled "Organization of 
Storage". On the TS1000 page 128 and page 255 
in the 2068 book, you will find a nice chart 
which depicts the byte structure of a Basic 
program line. As the chart says, the first 2 
bytes represent the line number (the HOT-Z 
display indicates that we must be looking at a 
line number 1), the second two bytes show the 
length of text plus the ENTER character which 
is always the last character of any program 
line. HOT-Z shows this line has a length of 52 
bytes (that's one byte for the REM token, 50 
X's, and | byte for the ENTER character. 
1+50+1=52). 
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Generally, you should not try to change these 
first four "pointers" of the program line 

unless you know what you're doing. We'll cover 
that at a later date, however, I will mention 
that HOT-Z can put whatever values you choose 
into these pointers. Changing the first two 
bytes will change the line number when you go 
back to Basic and list the program. Changing 
the second two bytes will do all kinds of 

crazy things. Many of them will cause your 
computer to crash the instant you go back to 
basic. The TS1000 version of MTERM (modem 
software) had these bytes changed as a copy 
protection scheme. Pro/File Updates Vol.2 No.4 
(pg.2-3) showed how to merge two smaller rem 
lines into | big one by changing these two 
length pointers. 


For our present task, we want to find the 
address of the first "X" after the REM token. 
This is where we are going to begin writing 
our machine code. Before going any further 
write down both the hex and decimal addresses 
of this "X". On the TS1000 it will be 4082 hex 
and 16514 decimal (does that number ring a 
bell?). On the TS2068 you should write down 
685B hex and 26715 decimal. 


¢ 
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Or the "end" of a block of memory you are - 
working on. It is hard to pin down the true 
meaning of END because at different times it 
represents different things. END always 
represents a hex address. Its value starts out 
at 8000 hex, but it can be changed to other 
values. As you learn to write machine code you 
will find yourself changing END (or Setting 
END) constantly to accomodate various tasks. 
Think of END as being an arbitrary end address 
of a block of memory. The starting address is 
defined by the location of the cursor. 
Depending on how you set END, this memory 
block can be large or small. 


I will cover the specific uses of END as I 
cover specific functions HOT-Z is capable of 
handling. But here are a few general uses just 
to give you an idea of END's purpose. 


When you print out a listing of a 
dissassembly, HOT-Z starts Iprinting at the 
cursor and stops at the address specified in 
END. 


When you SAVE or LOAD a block of data or 
machine code, the actual bytes processed range 
between CURSOR and END. 


Writing Machine Code When you need to insert a machine code command 


between two existing commands, the END address 


Now switch back to the DISASSEMBLY MODE is the last address to be bumped up when HOT-Z 


(SHIFT and "D" for TS1000, or Symbol Shift and 


"G" for TS2068) and then type the hex address 
you just wrote down for the first "X" of your 
REM line. This will clear the display of the 
line "pointers". Now you are ready to put 


HOT-Z into what is called the WRITE mode which 


is carried out by pressing SHIFT and "A" (for 
TS1000) or Symbol Shift and "A" (for 
TS2068).The top line of the display will 
change slightly and indicate that you have 
entered the WRITE mode. Immediately to the 
left of the mnemonic display a cursor will 


appear which is where a machine code command 


will be entered when we actually start to 
write it. 


The "END" Indicator 


A new indicator called "END" appears in the 
upper right corner of the screen. END is a 
VERY important variable which both you and 
HOT-Z use constantly in a wide variety of 
ways. "END" can be defined rather crudely as 
the "end" of the machine code you are writing. 


Scie 


makes room for the new instruction. 


The same is true when you delete an 
instruction. Only here, everything less than 
the END address is moved down. Values which 
lie beyond the END address are unchanged. 


How to Set "END" 


To assign new values to END, press the keys 
you normally use to produce the "TO" token 
(Shift and "4" for TS1000, Symbol Shift and 
"F" for TS2068). HOT-Z will respond by asking 
you to input a new 4 digit hex address for 
END. Whenever you write machine code, it is 
always a good idea to set END to the last byte 
of memory you plan to be working on. For our 
poposes, this means the last "X" in our REM 
line (40B3 for the TS1000 or 688C for the 
2068). So press "TO" and change END to the 
address appropriate for the computer you use. 


This will protect us against accidental 
erasures or insertions which, if END were 
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improperly set, might mess up our program line 
and cause the computer to crash when we go 
back to Basic. Even worse, a bad END could 
jumble up HOT-Z itself, and we could crash 
instantly! 


Use HOT-Z to Clear Memory Blocks 


With END safely set to the last X of the REM 
line, here's a good demonstration of how 

CURSOR and END work together to define a block 
of memory. HOT-Z has a "clear memory" function 
which sets every byte from the Write Cursor to 
the END address to the value of zero. This is 

not necessary to do before you start to write 
machine code, but now seems an appropriate 

time to show you this. 


To clear a block of memory on the TS1000, 
press Shift and Enter while you are in the 
WRITE mode. This changes the cursor into the 
letter "F" for FUNCTION. Now press the number 
"0". All bytes from CURSOR to END will change 
to zero. 


To clear a block of memory on the TS2068, 
press Symbol Shift and Caps Shift, then press 
Symbol Shift and "7". As in the TS1000, 
everything from CURSOR to END will become 
zero. 


In both computers, this function puts you back 
in the READ mode so if you are writing machine 
code, you must go back to the WRITE mode by 
pressing the proper keys for your computer. If 
you were to quit to basic now and list your 

rem line which held the 50 X's, you would find 
them all changed to CHRS 0 now. Try it if you 
don't believe me. 


Typing in Mnemonics 


If HOT-Z is in some other mode, press the 
appropriate keys to make your version go into 
the Write mode with the cursor beside the 
first character of the rem line (4082 for 
TS1000, 685B for TS2068). Be sure that END is 
set properly. Now you are ready to type in 
machine code mnemonics. Do this by simply 
pressing the letters and/or hex numbers used 
to make up the instruction. For example, the 
first command in the listing for the TS1000 is 
LD HL,(4004) so you would type an L, D, space, 
H, L, parenthesis, 4, 0, 0, 4, parenthesis, 

and then you press ENTER. 


HOT-Z then converts your mnemonic command into 
hexcode which it displays, and drops the 

cursor down to the next line. Also note that 

the "4004" in the mnemonic column is changed 

to "RMTP". This is a NAME which HOT-Z gives to 
the address 4004. HOT-Z has names for many of 
the key addresses and system variables used by 
the computer. In addition, it is possible to 

assign new names to your own addresses. When 

an address has a name, HOT-Z will 

automatically put the name into the 

disassembly because it holds more meaning than 

a plain number like "4004". In this case, RMTP 

is the name given to the system variable 
RAMTOP which is defined in the owner's manual 
as storing the address of the first byte above 

the Basic operating system. 


Names and Naming will be covered later. For 

now, I'll just say that you can use names 
interchangably with the addresses they 

represent. You could have just as easily typed 

in LD HL,(RMTP) when you entered the mnemonic. 
HOT-Z would have assembled the command 
properly. 


As you enter mnemonics, HOT-Z will check the 
syntax for you. If you do not enter the 
command correctly, the program will not 
assemble the line. Instead, the cursor will go 
back to the place where it lost track of what 
you were trying to write, and give you the 
chance to fix the line. Characters can be 
deleted by pressing the DELETE key (shift and 
"0"), The cursor can be moved left or right by 
pressing Shift and either the left or right 
arrow keys. 


If you are typing in a mnemonic and HOT-Z 
refuses to accept your line no matter how you 
try to fix it, you can restore the line to its 
original mnemonic by pressing Shift and ENTER 
(for TS1000) or Symbol Shift and "O" (for 
2068). This is very handy if you get half way 
into entering a mnemonic and then change your 
mind and decide to go back to the original. 


After a line has been entered, and the cursor 

is located at the beginning of the next line, 

you can move the cursor up or down by pressing 
Shift and one of the arrow keys. This permits 
you to skip lines of code, or go back toa 
previous one if you should spot an error. 


With these introductory remarks out of the 
way, try entering the remainder of the machine 
code. Choose the listing given for whichever 
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computer you are using and type in the 
mnemonics. 


TS1000 "FREE Memory" 


LD HL,(4004) 
LD DE,(401C) 


LD HL,(5CB2) 
LD DE,(5C65) 


SBC HL,DE SBC HL,DE 
PUSH HL PUSH HL 
POP BC POP BC 
RET RET 


Going Back to the READ Mode 


After you type in the last RETurn instruction 
and press Enter, you will be ready to go back 
to the READ mode, and from there, back to 
Basic to try your machine code out. To exit 


TS2068 "FREE Memory" 


from WRITE mode to READ mode, press just Enter 


when the write cursor is at the start of a 
mnemonic instruction. In other words, don't 
type a mnemonic, type just Enter to go back to 
the READ mode. 


From the READ mode you can quit to Basic to 
look at your program line. It looks quite 
different from the way it did when it was full 
of "X's", HOT-Z replaced them with the values 
representing the machine code you just typed 
in. 


From Basic, you can SAVE your program line so 
it can be loaded back for some other 
application. You can also try running it. 

This, of course, is not done by typing RUN. 

Use of the RUN command will cause Basic to 
run, but not machine code. To get machine code 
running, you use the USR function followed by 
the starting address of your machine code in 
decimal. This is the address you wrote down 
way back at the start of this article. 16514 

for the TS1000 and 26715 for the TS2068. So to 
execute this machine code on the 1000 and 
thereby find out how much free memory you 
have, enter the command, PRINT USR 16514. On 
the 2068, enter PRINT USR 26715. In both 
instances, the number of unused bytes will be 
printed on the screen. As more line numbers 
and Basic variables are added to memory, the 
machine code will print smaller and smaller 
results. 


What does the Machine Code Do? 


In our listing, the first command, 

LD HL,(RMTP) loads the HL register with the 
CONTENTS stored in the system variable called 
Ramtop. Two very similar looking mnemonics 
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perform very different functions which you 
should learn early in your machine code 
career. These are: 


LD rr,NN 
which loads the register with the number NN 
and 


LD rr,(NN) 
which loads the register with the CONTENTS of 
the address NN. 


The convention used in all Z80 mnemonics is to 
use the CONTENTS of an address whenever the 
address is enclosed by parentheses. If there 

are no parentheses surrounding the number, the 
number itself is loaded into the register. 


Therefore, the second instruction, 

LD DE,(STND) loads the DE register with the 
CONTENTS of the system variable called 
Stackend. 


Third, SBC HL,DE subtracts the value in DE 
from the value in HL and leaves the result in 
HL. 


The fourth and fifth instructions work 
together to transfer this result into the BC 
register. PUSH HL puts the end result of the 
subtraction on to the stack. Then, POP BC 
takes it right back again and puts it into 

the BC register. 


Finally, RET means RETURN from the subroutine. 
In other words, return to basic. Since the USR 
function is like a Gosub to machine code, and 
when it returns, it does so with a number 

equal to the BC register, you can use the 

Basic command PRINT USR xx to execute the 
machine code and print the contents of BC on 
the screen. Thus you see how much free memory 
remains. Simple, right? 


Final Note 


The first installment of HOT-Z Clinic in the 
last issue generated a lot of good response. So 

I guess I'm on the right track. Don't forget 

that you also have Ray Kingsley's instructions. 
They contain much useful information albeit a 
tad difficult to decipher. Take a little from this 
column and a little from Ray. By combining bits 
from several sources, learning how to use HOT- 
Z will come much more easily than when you 
depend solely on one source of information. 


BUG ALERT! 


Regretfully, I detected an error in the IBM Keyboard article which starts on page 4 of this issue. The error occurs in Table { on 
page 4. The address 64799 should be changed to 223, It should NOT be 207 as shown in the table. 


This change alters the keyboard disassembly given on page 9 to LD BC,SODF at address FDIE hex. The only effect of this alteration 


is to change the address of the port which reads the IBM keyboard signals. A port with the decimal address 207 would read the 
Keyboard if the change is not made. Otherwise port 223 will read the Keyboard. This is the address of the Experimenter’s Universal 


__ IN/QUT Port. 


